rotate
Type
command
Summary
Rotates an image through the specified angle.
Syntax
rotate [<image>] by <numberOfDegrees>
Description
Use the rotate command to turn an image.
The entire content of the specified image is selected with the Select paint tool, then rotated. If you don't specify an image, the portion currently selected with the Select paint tool is rotated.
If the numberOfDegrees is positive, the image rotates counterclockwise. If the numberOfDegrees is negative, the image rotates clockwise.
If the rotated image extends beyond the boundaries of the original image, and the image's lockLocation property is set to false, the image expands to accommodate the rotated contents. If the lockLocation is true, the rotated image is cropped to fit within the image's rectangle.
The current setting of the resizeQuality property is used to determine whether to apply filtering to the rotation operation. If set to normal no filtering is used; if set to good or best a bilinear filter is used which significantly reduces the distortion that will naturally occur when an image is rotated.
The rotation operation does not have an inverse. Since some amount of distortion is unavoidable when rotating an image by an amount that is not a multiple of 90 degrees, rotating an image clockwise, then counterclockwise by the same amount does not completely restore the original image.
To rotate an image in a reversible way, or to do repeated rotations without progressive distortion of the image, set its angle property instead of using the rotate command. Unlike the rotate command, the angle property affects only the screen display of the image, not the actual picture data in it, so setting it repeatedly does not introduce distortion.
Rotating an image using good or best resizeQuality might cause the mask to be promoted to an alpha channel.
As rotate is an image editing operation, the target image needs to be on the currently visible card of an open stack to function.
The rotate command cannot be used on a referenced image. Doing so will cause an execution error. To turn a referenced image, set the image'sangle property instead.
Parameters
| Name | Type | Description |
|---|---|---|
image | Any image reference. | |
numberOfDegrees | A number, or an expression that evaluates to a number. |
Examples
rotate image 1 by 90
rotate image "picture" by -10
Related
command: choose, crop, revRotatePoly
glossary: property, referenced control, paint tool, command, execution error
object: image
property: resizeQuality, angle, lockLocation
Compatibility and Support
Introduced
LiveCode 1.1
OS
mac
windows
linux
Platforms
desktop
server
mobile